home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d11
/
vuimg260.arc
/
VUIMG.DOC
< prev
next >
Wrap
Text File
|
1991-05-20
|
31KB
|
715 lines
VUIMAGE(tm) (Version 2.60) (Shareware)
GIF*/TIFF Format Picture Displayer/Printer
Copyright (C) 1990 Offe Enterprises. All rights reserved.
USERS MANUAL
Offe Enterprises, 1163 E. Ogden Ave. #705-131, Naperville, IL 60563 USA
708-357-6679
===============================================================================
Additions/Changes from the previous version (V2.53):
- Now supports printing of images. To choose printer, use the Options menu.
Print entire image, set your own print size.
- Now can dither images in 2-color display modes - none, 2x2, 3x3, 4x4
dithering
- Dither print output - none, 2x2, 3x3 or 4x4 dithering
- better Options menu
- reads more TIFF files
- memory requirement has increased to 150K
Additions/Changes from the previous version (V2.42):
- drivers for Trident, Video-7 1024i and Video-7 VRAM cards added
- select files using cursors, mark/unmark for list of files
- read more TIFF files - Vuimage Plus(tm) now supports PackBits
compressed bilevel TIFF files
Additions/Changes from the previous version (V2.3):
- user selectable screen colors ("-cd/-co/-cg/-cm" commandline options).
- Automatic video mode selection capability - a mode suitable for the
picture will be selected automatically. Detects CGA/Hercules/EGA/VGA
adapters and enables appropriate modes (user can still specify a
particular video mode).
- provides drivers for Everex 678, Video-7 Fastwrite
- 800x600x16 mode support for standard IBM VGA adapter
- video drivers have been re-named
- Changed pan step to 1/8 screen for TIFF files only
===============================================================================
OTHER PROGRAMS AVAILABLE FROM OFFE ENTERPRISES:
TBG(tm) - TIFF black&white/grayscale image to GIF/TIFF black&white/
grayscale converter (can reduce large b&w images to smaller
grayscale ones, convert TIFF to GIF etc.)
SCRtoPS(tm) - Dump text and graphics screens (CGA/EGA/VGA) to PostScript*
printer or capture to Encapsulated PostScript file (including
line/box characters). Requires only about 10K of resident
memory.
See file PROGRAMS.DOC for more information on these programs.
===============================================================================
* GIF and "Graphics Interchange Format" are trademarks (tm) of Compuserve,
Inc., an H&R block company. PostScript is a trademark of Adobe Systems, Inc.
VUIMAGE, VUIMAGE PLUS, TBG and SCRtoPS are trademarks of Offe Enterprises.
INTRODUCTION
Offe is proud to bring you our GIF/TIFF display software for the IBM PC family.
Its main features are:
- super fast display of GIF files and bilevel/grayscale TIFF files
- print GIF and TIFF files (four dithering options)
- print entire image, set your own print size
- requires only 150K of free memory to run
- supports a variety of display types - CGA/Hercules/6300/DEB/EGA/MCGA/
VGA/SuperVGA
- 320x400x256, 360x480x256 and 800x600x16 driver for standard IBM VGA
- excellent color rendition in all video modes
- four dithering options for two-color video modes
- handles large images
- automatic/manual video mode selection capability
- auto/manual scaling - automatically scale to full screen or
manually scale from 1% to 999%
- zoom in / zoom out using the "+" and "-" keys
- panning - cursor keys allow moving screen window over different sections
of picture
- adjust brightness while picture is on screen
- supports other boards/future boards through BIOS mode
- user-friendly, multiple interfaces
- menu-selectable options
- command-line selectable options (useful in batch files and when
called as a sub-program by other programs)
- pre-programmed keystroke mode (std. input re-direction)
- select files using cursor or by file numbers
- specify a list of files to be displayed for slide shows
- continuously repeat list of files (for demos etc.)
- abort single picture or list of pictures in the middle
- handles corrupt files well
- returns DOS errorlevel value (useful in batch files and when
called as a sub-program by other programs)
- user selectable menu screen colors
We hope you like our product and decide to register. Registered users get
VUIMAGE PLUS(tm) Version 2.60, our non-shareware version of the program with
the following added features:
- menus may be disabled and file (or files) to be shown may be specified from
the command line (in this mode, the image may be left on the screen when
the program ends)
- print options may be specified from the command line (you can create a
batch file easily to "configure" VUIMAGE PLUS(tm)).
- compressed bilevel TIFF files (compression type - CCITT Group 3-1D or
compression type PackBits) can be viewed. Many scanners come with
software that can produce such files.
REGISTRATION
This version of the program is released as shareware. It is not free and is
not in the public domain. Private, non-commercial users are requested to
register and support its continued development. To register, please send your
name, address and phone number(s) with the registration fee of US $30.00** to:
Offe Enterprises, 1163 E. Ogden Ave. #705-131, Naperville, IL 60563 USA
Registered users get VUIMAGE PLUS(tm) Ver 2.60 (Outside US, please add $5.00**).
Any form of commercial use of VUIMAGE(tm) is strictly prohibited. Commercial
users should purchase VUIMAGE PLUS(tm), the non-shareware version. Volume
discounts and site licenses are available for VUIMAGE PLUS(tm). Contact Offe
Enterprises for customized versions.
DISTRIBUTION
You may make copies of the program files for VUIMAGE(tm) and the documentation
VUIMG.DOC (this file) together and distribute them to others, upload to
bulletin boards etc. for non-commercial purposes. The program files should
not be distributed without the documentation file VUIMG.DOC. None of the
files should be modified in any way.
NOTICE
This program, and all supporting programs and documentation are provided
"as is" without warranty of any kind, either expressed or implied, including
but not limited to the implied warranties of merchantability and fitness for
a particular purpose. In no event will Offe Enterprises be liable to you for
any damages arising out of the use or inability to use this program and/or all
supporting programs and documentation.
** All prices and other information are subject to change without notice.
INSTALLATION AND USAGE
Note: Requires MS-DOS Version 2.0 or later and at least 150K of free memory.
1. FLOPPY DISK Copy all the files from the program disk to another floppy
disk. Use this as your working disk - place this disk into
drive A:, type "A:" and press return. Go to step 2.
HARD DISK Make a new subdirectory. For example, if you are using
drive C: and the subdirectory name is \VUIMAGE, enter
c:
md \vuimage
Now make this subdirectory your current directory. In our
example, enter
cd \vuimage
Copy all the files from the program disk to this subdirectory.
Go to step 2.
2. Now all the files are in the current drive/directory. To start the program,
type "vuimg" at the DOS prompt and press return.
You will be placed in the main menu. Also shown will be a list of files
in the current directory that have the extension "GIF". The current display
mode will be displayed at the bottom left of the screen. The main menu
options are displayed at the bottom right of the screen.
Press "Q" to quit back to DOS. Go to step 3.
3. You can execute the program any time by changing to the subdirectory that
has the program files and typing "vuimg" as in step 2. However, it is
much more convenient to create a "batch file" that will execute the
program from any directory. WE RECOMMEND THAT YOU DO THIS so that you
can "configure" the program this way to suit your own needs. You can
create a batch file by typing
copy con: v.bat <return>
where "v.bat" is the name of the batch file. Now enter the program
name along with the drive and directory name. For example,
c:\vuimage\vuimg <return>
Then press <ctrl>-Z followed by a <return> to finish creating the batch
file (you can also use an editor to create this file). Now you can start
the program by typing "v" and return. The batch file need not be kept
in the same subdirectory as the program files. However, the sub-directory
that it is kept in must be part of your "PATH". The PATH is a list of
directories that DOS will search when you type in a command. Refer to
your DOS manual for information on PATH and how to add a sub-directory to
your PATH.
After you become familiar with the command line options of the program (see
later section on command line options), you can re-create the batch file
and also specify the command line options that you normally prefer to use.
MAIN MENU
From the main menu, at the "File(s)" prompt, you can enter:
- "t" to select the file type - GIF or TIFF
- "m" to change the display mode
- "s" to change the scaling options
- "o" to change other user selectable options
- "d" to select a different directory/different group of files
- "q" or ESC to quit and go back to DOS.
- a list of picture files to be displayed. For example, enter
3,1,5-7,17-14 <return>
to display files 3,1,5,6,7,17,16,15,14 from the list (in that order).
- the up arrow to select files using the cursor keys. To display a
single file, move the cursor bar to the file and press enter. To
display a list of files, move to each file and press the space bar
to select (mark) the file. Press enter to display the marked files
or "/" to continuously repeat the list of files. If there are too
many files to fit on one screen, use the PgUp/PgDn keys to see
other files. To get back to the main menu, press the escape key.
SELECTING THE FILE TYPE
The default file type is "GIF". To select between TIFF and GIF, press "t"
at the main menu prompt. You can also select the file type from the command
line using the "-T" option (for example, -Ttiff will select TIFF - see section
on command line options).
SETTING THE DISPLAY MODE
The program selects a video display mode appropriate for the video adapter
and the picture being displayed automatically. The mode is chosen from the
CGA/Hercules/EGA/VGA modes present and any modes supported by any extended
mode driver that has been loaded (extended mode drivers are selected by the
command line option "-v" - see section "Display Boards and Extended
Modes/Drivers" for more details on extended modes).
If the user desires to select a particular video mode to display the picture
instead of the automatically selected mode, this can be done by pressing
"m" at the main menu prompt, going into the display mode menu and changing
the display mode. An appropriate mode supported by your video display
board may be specified. If any extended video mode drivers have been
loaded, the extended modes supported by these drivers are also listed.
Instead of using the menu, you can also specify the mode to be used from the
command line by using the "-m" option (for example, "-m7" will use the
EGA 640x350 16-color mode - see section on command line options).
There is also a "BIOS" mode that you can use for extended modes that are
unsupported. Your display board will need to provide complete BIOS support.
Usually the BIOS mode is extremely slow.
If you are using a video mode that has only 2 colors, you can use dithering
to improve the displayed picture. Use the Options menu to select a type
of dithering to be used for 2-color modes.
DISPLAYING PICTURE FILES
From the main menu, enter the number of the file you wish to display and
press return. If you wish to display a sequence of files, you can enter
a set of numbers, separated by commas:
Example: 3,5 <return> will display file 3 followed by file 5.
You can enter a starting number and an ending number to display a list of
files:
Example: 2,5-7 <return> will display files 2, 5, 6 and 7.
Example: 2,7-5 <return> will display files 2, 7, 6 and 5.
After you enter a list of files (or one file) and press return, the picture(s)
are displayed in sequence.
Alternately, you can press the "up arrow" to select files using the cursor.
To see one file, move the cursor bar to the file and press return. To
select a list of files, "mark" each file by moving the cursor bar to it
and then pressing space bar. When you press return, the files will be
displayed in sequence.
TIMEOUT
Each picture is displayed for a default time of 20 seconds. Pressing a
return, however, will force the display to end and move on to the next
picture or back to the main menu. The timeout value can be changed from
the "Options" menu or from the command line using the -t option.
ABORT PICTURE
Pressing the ESC key while a picture is being drawn aborts that picture.
You can abort a list of pictures by pressing the ESC key twice.
REPEATING LISTS
When you enter a list of pictures in the main menu, if you end the list with
the forward slash ("/") instead of a <return>, the list will be continuously
repeated. To abort this repeated display, press the ESC key twice in quick
succession.
SELECTING THE DISPLAY DIRECTORY
From the main menu, press "d" to change the display directory (the directory
containing the picture files). The files in this directory will be listed
when you return to the main menu.
If only a directory name is specified, all files that have an extension
of GIF or TIF (depending on file type selected) in that directory will be
displayed. If you want to list other files also, enter an appropriate string
to be matched.
Examples:
To list Enter
all files in the current directory *.*<return>
all files with extension GIF in the current directory *.gif<return>
all files with extension GIF or TIF (depending on pics<return>
file type) in the subdirectory "pics" of the
current directory
all files with extension GIF or TIF (depending on \picdir<return>
file type) in the subdirectory "picdir" of the
root directory
all files in the subdirectory "picdir" of the root \picdir\*.*<return>
directory.
You can also set the display directory from the command line using the -d
option.
SCALING OF PICTURES
There are many scaling options. The default scaling is 1:1 i.e. no scaling.
You can choose to set the scales manually. You can also have the program
perform auto-scaling. The "auto-scale full screen" option makes the picture
"fit" the screen horizontally and vertically. You can also auto-scale
with the constraint that the horizontal and vertical scales should be equal.
Use the "Scale" menu to change the scaling options. You can also select
the scaling method from the command line using the -s option.
ZOOMING
Once a picture is displayed on the screen, you can zoom in using the "+" key
and zoom out using the "-" key.
PANNING
Once a picture is displayed on the screen, you can move the viewing window
around the picture by the use of the cursor keypad:
(Number lock should be disabled)
down arrow (or "d") move down half screen (1/8 screen for TIFF)
right arrow (or "r") move right half screen (1/8 screen for TIFF)
up arrow (or "u") move up half screen (1/8 screen for TIFF)
left arrow (or "l") move left half screen (1/8 screen for TIFF)
"End" (or "1") move to bottom left corner
"PgDn" (or "3") move to bottom right corner
"PgUp" (or "9") move to top right corner
"Home" (or "7") move to top left corner
(Scroll lock should be disabled)
shift-down arrow (or "2") move down full screen
shift-right arrow (or "6") move right full screen
shift-up arrow (or "8") move up full screen
shift-left arrow (or "4") move left full screen
BRIGHTNESS
Once a picture is displayed on the screen, you can increase the brightness
by pressing the "b" key and reduce the brightness by pressing the "B" key.
PRINTING
Once an image is displayed on the screen, you can print that image by
pressing the "p" key. Before printing, make sure that you have set up
the printer port and selected the correct printer by going into the
Options menu.
The entire image is printed. Any brightness adjustments you have made
will affect the print output. The output to 2-color printers (most printers)
can be dithered so as to obtain a better print-out. You can choose between
no dithering, 2x2 dithering, 3x3 dithering or 4x4 dithering by going
into the Options menu. You may wish to experiment with the dithering
options to obtain the best print image. For fairly high resolution
printers (200x200 dpi or greater), 3x3 or 4x4 is suggested for paint-type
images, and 1 or 2x2 for line art/scanned documents.
From the Options menu, you can also set the desired size of the print-out.
You can specify "lpt1:","lpt2:","lpt3:","com1:","com2:" or a filename
for the printer port.
TEXT SCREEN COLORS
You can change the text screen colors used by going into the "Options"
menu and answering "y" when asked "Change Screen Colors ?".
Use the left/right arrow keys to change the foreground color and the
up/down arrow keys to change the background color. (Alternately, you can use
the "f" and "F" keys for foreground and the "b" and "B" keys for background).
Select the colors you like. Note the numbers shown that corresponds to each
of the colors that you selected - these numbers can be used with the "-cd",
"-co" and the "-cg" command line options to automatically select your
favourite colors when the program is started.
^L
COMMAND LINE OPTIONS
Many of the options may be set from the command line instead going through
a menu. For example, to start the program with the mode option set to 9
and the scaling option set to 3, enter:
vuimg -m9 -s3
The available command line options are listed below:
-Tfiletype where filetype is "gif" or "tiff".
to go into the "Mode" menu and make a selection.
Example: -Ttiff (display tiff files)
-vdrivername where drivername is the name of the extended mode driver
appropriate for your board. If the program files are not in
the current directory, then the drive and subdirectory must
also be specified.
Example (load ATI VGAWonder driver):
-vdativ (program files in current dir)
-vc:\vuimage\dativ (program files in c:\vuimage)
-mmodeindex where modeindex is the number you would enter if you were
to go into the "Mode" menu and make a selection.
Example: -m9 (set 320x200x256 mode)
-sscaleindex where scaleindex is the number you would enter if you were
to go into the Scale menu (part of the "Options" menu) and
make a selection.
Example: -s3 (set autoscale full screen)
-sxhscale where hscale is the horizontal scale value (1% to 999%).
This option should be used only if manual scaling is selected.
Example: -sx200 (set horizontal scale to 200%)
-syvscale where vscale is the vertical scale value (1% to 999%).
This option should be used only if manual scaling is selected.
Example: -sy50 (set vertical scale to 50%)
-ddirectory where directory is a directory name (or file matching string)
that you would enter when you go into the Dir menu.
-ttimeout where timeout is the number of seconds to display each picture.
Example: -t40 (set timeout to 40 seconds)
-by enables the beep at the end of a picture
-bn disables the beep at the end of the picture
Example: -bn (disable beep)
-Bbrightness where brightness is the brightness value (100 is nominal)
Example: -B120 (set brightness to 120%)
-cddircolor where dircolor is the color number for the filenames
-cofncolor fncolor is the color number for the file numbers
-cmmodcolor modcolor is the color number for the display mode
-cggencolor gencolor is the color number for general text
To find the color numbers for the colors of your choice, first
go into the "Options" menu and select the colors that you like.
The corresponding color numbers are also displayed.
Example: -cd78 (filenames in yellow on a red background)
-co10 (filenumbers in bright green on black)
-cm4 (video mode in red on black)
-cg14 (general text in yellow on black)
(*** The following options are available only in VUIMAGE PLUS(tm) ***)
-pdprinternum where printernum is the number you would enter if you were
to go into the Options menu and choose a printer.
Example: -p1 (select EPSON FX80/100 printer)
-pddevicename where devicename is the printer device (lpt1:, lpt2:, lpt3:,
com1:, com2: or filename).
Example: -pdlpt1: (send output to lpt1:)
-pdvuimg.prn (send output to file vuimg.prn)
-pxwidth where width is the width of the printed image in 1/100 inches
Example: -px904 (print image width=9.04 inches)
-pyheight where height is the height of the printed image in 1/100 inches
Example: -py1200 (print image height=12.00 inches)
-fddithertype where dithertype is the number you would enter if you were to
go into the Options menu and choose the display dither type.
Example: -fd3 (dither 2-color displays using 3x3 matrix)
-fpdithertype where dithertype is the number you would enter if you were to
go into the Options menu and choose the printer dither type.
Example: -fd4 (dither 2-color printers using 4x4 matrix)
-C disables the menus. If you use this option, you must also
specify a filename to be displayed including the pathname.
This should be the last option entered on the command line.
The filename may contain wild card characters ? and * and
should be the last parameter. Any directory name entered
with the -d option will be ignored.
Examples: -C somefile.gif
-C \pics\*.gif
-L leave the last image on the screen when the program ends.
Valid only when the -C option is used. Useful when called
as a sub-program by another program.
PRE-PROGRAMMED MODE
You can run the program in a PRE-PROGRAMMED mode where it will go through a
display session with no keyboard input. To do this, go through a manual
session and write down all keystrokes till you quit back to DOS (this is
important). If you use the ESC key to abort a picture or list,
the return key to move on to the next picture, or the cursor keys to do
panning, do NOT include these keystrokes. Then create a file containing
these keystrokes (we will use the filename "vuimg.inp" in the following
example). To do this, type:
copy con: vuimg.inp <return>
Enter the keystrokes you wrote down and then type a <CTRL>Z to create the
file called vuimg.inp. A text editor (ex. edlin) may also be used to
create such a file (start a new line for every "return" key). This file
may then be used to run the program in the PRE-PROGRAMMED mode by typing
vuimg < vuimg.inp
DOS EXIT CODES (ERRORLEVEL)
---------------------------
The return codes generated by the program that may be tested in a batch
file are:
0 - no error
1 - command line option error
2 - the -C option was used without specifying a file
3 - file not found or invalid filename
DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS
-----------------------------------------------
If the program does not work with your display board, try loading any software
drivers (BIOS emulators, int 10h drivers, RAM BIOS drivers) that come with it.
Refer to the instructions that come with your graphics board.
Some video display boards support even higher resolutions than standard VGA,
for example, 640x480 in 256 colors and 800x600 in 16 colors. These are
sometimes referred to as SuperVGA modes. Additional drivers that support
these "extended modes" are included with the program. These drivers are listed
later in this section and can be loaded using the "-v" command line option
(see section on command line options).
Extended modes are dependent on your type of graphics board. Refer to your
graphics board manual to see what additional modes are supported. Only VGA type
extended modes with either 16 or 256 colors out of a palette of 262,144
colors are supported by the drivers.
If you are not using any extended drivers, you may still be able to display
in an extended mode if your BIOS for the board will support this. Not all
boards come with BIOS that support the extended modes completely. Installing
any RAM BIOS drivers that come with your board may help. Display done
through the BIOS is usually extremely slow.
To use the BIOS supported extended modes, you need to know the mode number,
the no. of columns, the no. of rows, and the no. of colors for the mode.
Refer to the manual for your graphics card.
Extended Mode Drivers (SuperVGA drivers) included:
If your display board is: Try driver
------------------------ ----------
ATI VGAWONDER DATIV
Paradise VGA cards DPVGA
AST VGA cards DPVGA
AT&T VDC600 DPVGA
Orchid ProDesigner DORCH
STB VGA cards DORCH
Genoa VGA cards DORCH
Sigma VGA cards DORCH
Standard IBM VGA & register compatibles
with multisync monitors DNVGA
Everex EV673 DE673
Everex EV678 DE678
Video-7 Fastwrite DV7FW
Video-7 1024i DV71024
Video-7 VRAM DV7VRAM
Trident Video cards DTRID
If your board is not listed, you can try one of the supplied drivers
to see if any of the extended modes will work. Other drivers may become
available from Offe in the future. Not all modes available are supported
on the listed boards.
Extended Modes Supported by the Drivers (mode numbers in decimal and hex)
DATIV
Mode 84 (54h) 800 x 600 x 16 colors
Mode 97 (61h) 640 x 400 x 256 colors
Mode 98 (62h) 640 x 480 x 256 colors
Mode 99 (63h) 800 x 600 x 256 colors
Mode 101 (65h) 1024 x 768 x 16 colors
DE673
Submode 19 (13h) 640 x 350 x 256 colors
Submode 20 (14h) 640 x 400 x 256 colors
Submode 21 (15h) 512 x 480 x 256 colors
DE678
Submode 49 (31h) 640 x 400 x 256 colors
Submode 50 (32h) 512 x 480 x 256 colors
Submode 77 (4dh) 640 x 480 x 256 colors
Submode 78 (4eh) 800 x 600 x 256 colors
DNVGA
------- 320 x 400 x 256 colors
------- 360 x 480 x 256 colors
------- 800 x 600 x 16 colors
DORCH
Mode 41 (29h) 800 x 600 x 16 colors
Mode 45 (2Dh) 640 x 350 x 256 colors
Mode 46 (2Eh) 640 x 480 x 256 colors
Mode 47 (2Fh) 720 x 512 x 256 colors
Mode 48 (30h) 800 x 600 x 256 colors
Mode 55 (37h) 1024 x 768 x 16 colors
DPVGA
Mode 88 (58h) 800 x 600 x 16 colors
Mode 94 (5Eh) 640 x 400 x 256 colors
Mode 95 (5Fh) 640 x 480 x 256 colors
DV7FW
Mode 98 (62h) 800 x 600 x 16 colors
Mode 102 (66h) 640 x 400 x 256 colors
Mode 103 (67h) 640 x 480 x 256 colors
DTRID
Mode 91 (5Bh) 800 x 600 x 16 colors
Mode 92 (5Ch) 640 x 400 x 256 colors
Mode 93 (5Dh) 640 x 480 x 256 colors
Mode 95 (5Fh) 1024 x 768 x 16 colors
DV71024
Mode 98 (62h) 800 x 600 x 16 colors
Mode 101 (65h) 1024 x 768 x 16 colors
Mode 102 (66h) 640 x 400 x 256 colors
Mode 103 (67h) 640 x 480 x 256 colors
DV7VRAM
Mode 98 (62h) 800 x 600 x 16 colors
Mode 101 (65h) 1024 x 768 x 16 colors
Mode 102 (66h) 640 x 400 x 256 colors
Mode 103 (67h) 640 x 480 x 256 colors
Mode 105 (69h) 800 x 600 x 256 colors